Repository navigation
Fix agent setup for non-Claude agents; point product feedback at report_feedback - #892
Merged
Merged
Conversation
…rt_feedback Agent feedback from Sep 9 to Oct 13 showed these install steps failing or misleading agents: - skills install: pass --agent so the CLI stops printing "Failed to install" for PromptScript; add the agent-id table, a Node 22.20 check, and a verify step. - Codex: `codex plugin add runpod@runpod` replaces the UI-only /plugins step; `codex mcp add` takes --url, not --transport http. - Other agents: register the hosted MCP directly (Gemini, Pi commands; config entry for the rest). The guided wizard is interactive and only covers five clients, so it becomes a user step. - Verify: explain an empty Pod list on a funded account (wrong OAuth account). - No hard-coded skill counts. - Feedback: docs feedback stays on the docs MCP's submit_feedback; product and MCP-tool problems go to report_feedback on the Runpod MCP (page section and the global markdown instructions in docs.json). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
This was referenced Oct 13, 2026
justinwlin
approved these changes
Oct 14, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Agent feedback collected Sep 9 to Oct 13 (≈300 reports through the Runpod MCP) showed the "Install for other agents" path on
/agent-setupfailing or misleading agents. #889 fixed the skill list. This PR fixes what's still broken.Changes to
agent-setup.mdx--agent <agent-id>plus an id table taken from theskillsCLI (1.7.2). Without--agent,--yes --globaltargets every known agent and printsFailed to install Nfor PromptScript, which agents read as a total failure (6 reports, 2 from today). Also adds the Node 22.20 requirement (fromskillsengines) and askills list --globalverify step.codex plugin add runpod@runpodreplaces the UI-only/pluginsuser step. The fallback is nowcodex mcp add runpod --url …, since--transportis no longer a Codex CLI flag (4 reports). Adds a note to restart Codex Desktop.npx @runpod/mcp-server@latest add. That's a TTY-only wizard that exits 0 without writing config in an agent shell, and it only supports Claude Code, Cursor, Windsurf, Claude Desktop and VS Code (6 reports, including opencode and Pi). Agents now register the hosted URL directly (Gemini and Pi commands; a config entry for the rest), and the wizard becomes a User step.known_hostserror); Codex, opencode and Cline doc links.Feedback routing (
agent-setup.mdx+docs.json)Docs feedback stays on the docs MCP's
submit_feedback. Both the new page section and one added sentence in the globalmarkdown.instructionsnow say that product or Runpod MCP tool problems go toreport_feedbackonhttps://mcp.getrunpod.io/. Agents were mixing the two up (5 reports).Depends on
runpod/runpod-plugins-official#83, which marks the two contributor skills
internal. Until it merges,--skill '*'installs 2 extra contributor skills. Merge #83 first.Testing
mint validate: build validation passed.mint broken-links: identical output tomain(the 8 existing broken links are all on the globalvolume pages; none are new).node scripts/validate-tooltips.jsandnode scripts/validate-redirect-sources.jspass.mint dev: the agent-id table, code blocks and banner display correctly.--skill '*' --agent codexwas run against the Update runpodctl reference docs to 1.14.3 and fix MacOs install #83 branch into a throwaway HOME (15 skills, no failures).codex plugin add/codex mcp add --urlwere checked on codex-cli 0.153.4 andgemini mcp addlocally. The Pi command comes from a user report and wasn't tested.🤖 Generated with Claude Code